home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
DS-CD ROM 2 1993 August
/
DS CD-ROM 2.Ausgabe (August 1993).iso
/
programm
/
ds0594
/
handbuch.txt
< prev
next >
Wrap
Text File
|
1993-05-31
|
10KB
|
266 lines
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
▓▓ ▓▓░░
▓▓ LISTER.EXE ▓▓░░
▓▓ ▓▓░░
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░
░░░░░░░░░░░░░░░░░░░░░
Shareware-Version 3.3
Listingoptimierer für dBASE-Programmcode
LISTER.EXE Seite 1
──────────────────────────────────────────────────────────────────────────────
K U R Z A N L E I T U N G
Das Utility LISTER.EXE liest dBASE - Quellcodedateien und bereitet ihre
Form etwas auf:
- alle Leerzeilen werden entfernt,
- alle führenden Leerzeichen und Tabulatoren werden entfernt,
Schleifen und Bedingungen durch Leerzeichen eingerückt,
- logische Werte und Konjunktionen (.T., .F., .AND., .OR., .NOT.) werden
in Großbuchstaben umgewandelt, davor und danach ein Leerzeichen einge-
fügt,
- vor und nach den vier Rechensymbolen (+, -, *, /) und dem Gleichheits-
zeichen wird ein Leerzeichen eingefügt, falls es nicht schon vorhanden
ist,
- nach einem Komma und der schließenden Klammer wird ein Leerzeichen ein-
gefügt,
- wahlweise fortlaufende Zeilennummern,
- wahlweise optische Hervorhebung von Schleifen und Bedingungen,
- alle Befehle und Variablen werden in Kleinbuchstaben umgewandelt,
können jedoch wahlweise in Großbuchstaben ausgegeben werden,
- Kommentare in Befehlszeilen ("&&") auf Fluchtlinie.
- Kommentarzeilen, die mit einem Asterisk "*" beginnen, werden unver-
ändert übernommen,
- Programmzeilen zwischen den Befehlen TEXT ... ENDTEXT werden unver-
ändert übernommen.
- Programmzeilen, die mit dem Befehl RUN beginnen, werden unverändert
übernommen.
- Wahlweise kann die aktuelle Version vor die Datei geschrieben werden.
- Wahlweise kann ein Vorspann vor die Datei geschrieben werden.
Das Programm erstellt eine ASCII-Datei, die den aufbereiteten Quellcode ent-
hält. Gleichzeitig können Sie den Text wahlweise auf den Bildschirm und/oder
Drucker ausgeben lassen. Wenn Sie bereits während der Programmierung Ihren
Quellcode ausführlich dokumentieren, erhalten Sie damit eine komplette Pro-
grammbeschreibung mit sämtlichen Informationen über das Programm.
LISTER.EXE Seite 2
──────────────────────────────────────────────────────────────────────────────
INSTALLATION:
Auf der Diskette sollten Sie folgende Dateien finden:
BESTELL.TXT - Bestellformular für Vollversion
DBCOMP.PRG - dBASE IV-Quellcode zur Demonstration
DBCOMP.ASC - mit LISTER bearbeitete Datei
DBCOMP.DBF - wird für DBCOMP.PRG benötigt
HANDBUCH.TXT - Bedienungsanleitung
LISTER.EXE - Programm
DSINFO.TXT - Informationen zur DS
Kopieren Sie die Datei LISTER.EXE in ein beliebiges Unterverzeichnis der Fest-
platte, auf das ein Pfad gelegt wurde (z. B. PATH = C:\DOS).
BEDIENUNG:
Das Programm unterscheidet zwischen dem interaktiven und dem Batchmodus.
Im interaktiven Modus können Sie erforderliche Einstellungen selbst vornehmen,
im Batchmodus läuft das Programm völlig selbständig und eignet sich deshalb
für den Aufruf aus Batchdateien.
1. Starten Sie das Programm vom aktuellen Laufwerk oder Unterverzeichnis mit
dem Aufruf
C:> LISTER <Filename> [/A | /B | /?]
Beim Aufruf ohne <Filename> erhalten Sie darauf eine Auswahl aller vor-
handenen Dateien mit der Endung .PRG . Wählen Sie die zutreffende Datei
mit dem Leuchtbalken aus.
Mit den Tasten "Page Down" und "Page Up" können Sie in der Auswahl blät-
tern.
Mit dem Parameter /A starten Sie den Batchmodus für ASCII-Dateien. Sie er-
halten eine Datei mit der Endung .ASC, die Zeilennummern und die grafische
Aufbereitung der Schleifen und Bedingungen enthält. Die evtl. vorhandene
Version wird nicht geändert.
Mit dem Parameter /B starten Sie den Batchmodus für PRG-Dateien. Die vor-
handene Quellcode-Datei wird in .BAK umbenannt. Sie erhalten eine Datei
mit der Endung .PRG, die nur den aufbereiteten Quellcode enthält (keine
Zeilennummern und grafische Aufbereitung der Schleifen und Bedingungen).
Die Version wird entweder eingefügt oder geändert.
Diese Datei können Sie problemlos unter dBASE oder CLIPPER einsetzen.
Mit dem Parameter /? wird ein Hilfebildschirm ausgegeben.
Ohne die Parameter /A und /B startet das Programm im interaktiven Modus.
Hier können Sie die Einstellungen selbst vornehmen.
LISTER.EXE Seite 3
──────────────────────────────────────────────────────────────────────────────
2. Im interaktiven Modus erhalten Sie als nächstes die Eingabemaske. Hier
können Sie folgende Einstellungen vornehmen:
- Programmname
ist der Name Ihrer dBASE - Quellcodedatei (Endung immer .PRG)
- Textdatei
ist der Name der ASCII-Datei, die erstellt wird (Endung immer .ASC)
- Version ausgeben
geben Sie hier ein "J" ein, wird die aktuelle Versionsnummer des Quell-
codes ausgegeben
- Großbuchstaben
geben Sie hier ein "J" ein, wird der Quellcode in Großbuchstaben ausge-
geben
- Linker Rand
ist der linke Rand des Ausdrucks (nur auf Drucker wirksam)
- Zeilen je Seite
ist die Anzahl der Zeilen des Ausdrucks (nur auf Drucker wirksam)
- Zeilennummern
schaltet die Ausgabe von Zeilennummern ein oder aus
- Grafik
schaltet die Hervorhebung von Schleifen und Bedingungen durch Grafikzei-
chen ein oder aus
- Vorspann
gibt einige Kommentarzeilen aus. Hier können Sie anschließend Beschrei-
bungen zum Programm eintragen. Die in der Datei enthaltenen Prozeduren
und Funktionen werden automatisch ermittelt und aufgeführt.
- An Drucker
der erstellte ASCII-Text wird sofort an den Drucker gesandt.
Schalten Sie den Drucker zweckmäßigerweise auf einen kleinen Zeichen-
abstand. Der Ausdruck wird dadurch übersichtlicher.
- An Bildschirm
der erstellte ASCII-Text wird auf dem Bildschirm ausgegeben
Das Programm erstellt dann im aktuellen Laufwerk oder Unterverzeichnis die
ASCII-Datei und gibt den Text wahlweise auf den Drucker und/oder den Bild-
schirm aus.
LISTER.EXE Seite 4
──────────────────────────────────────────────────────────────────────────────
!!! WICHTIG !!!
- Das Programm legt während des Ablaufs einige temporäre Dateien an,
deren Größe von der Länge des Quellcodes abhängt. Sie können diese
Dateien durch Setzen der Umgebungsvariablen TEMP auf ein beliebiges
Laufwerk (z. B. RAM-Disk) umleiten. Geben Sie dazu im Betriebssystem
z. B. ein:
SET TEMP=D:\ <Return>
- Die größte Zeilennummer, die das Programm vergeben kann, ist 99.999.
Ist Ihr Quellcode länger, müssen Sie die Zeilennummern in der ASCII-
Datei nachträglich ändern.
- Das Programm kann nur Zeilen mit einer maximalen Länge von 256 Zeichen
bearbeiten. Enthält Ihr Quellcode längere Zeilen, sollten Sie vor der
Bearbeitung die Zeilen durch das Semikolon ";" trennen.
- Das Programm erwartet, daß Sie den Quellcode ausschreiben (nicht nur
4 Buchstaben). Außerdem sollten Sie auf Kommentare "&&" in Befehlszeilen,
die nachfolgende Schlüsselwörter enthalten, verzichten. Dies kann bei der
optischen Aufbereitung der Schleifen und Bedingungen zu Fehlern führen.
- Das Programm erkennt folgende Schleifen und Bedingungen:
o IF ... ELSE ... ENDIF
o DO CASE ... CASE ... OTHERWISE ... ENDCASE
o DO WHILE ... ENDDO
o FOR ... NEXT
o SCAN ... ENDSCAN
o PRINTJOB ... ENDPRINTJOB
o BEGIN TRANSACTION ... END TRANSACTION
o TEXT ... ENDTEXT
- Das Programm arbeitet am schnellsten im Batchmodus, da die gleichzeitige
Bildschirm- und/oder Druckausgabe den Ablauf bremsen.
LISTER.EXE Seite 5
──────────────────────────────────────────────────────────────────────────────
COPYRIGHT:
LISTER ist ein durch das Urheberrechtsschutzgesetz geschütztes Programm.
Sie finden auf dieser Diskette eine voll funktionstüchtige Prüfversion.
Diese Shareware-/Prüfversion darf sowohl kommerziell wie privat beliebig
kopiert und verteilt werden. Nur durch Ihre Mithilfe bei der Werbung und
durch den Direktvertrieb können Shareware-Produkte sehr preiswert ange-
boten werden.
Bitte zahlen Sie bei regelmäßiger Benutzung dieses Programms die Lizenz-
gebühr von 50 DM. Sie erhalten dann die neueste Vollversion. Mit Ihrer
finanziellen Unterstützung von Shareware-Autoren fördern Sie die Entwik-
klung preiswerter Software. Einen Bestellschein finden Sie in der Datei
BESTELL.TXT.
Ich übernehme keinerlei Haftung für Schäden an Rechnern oder Datenverluste aus
dem Gebrauch von LISTER.
Falls Sie Tips oder Verbesserungsvorschläge zu LISTER haben, teilen Sie sie
mir bitte mit. Vielen Dank im voraus für Ihre Unterstützung.
Erlangen, 1. Juni 1993
Bernd Hohenester
Aschaffenburger Straße 16
D-91056 Erlangen
Tel.: (09131) 4 87 88